home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / OS2 / EABK20.ARJ / README.DOC < prev   
Text File  |  1992-07-09  |  34KB  |  669 lines
  1.  
  2.  
  3.                         Version 2.01. July 9, 1992
  4.  
  5.  
  6.                              Table of Contents
  7.  
  8.         IMPORTANT INFORMATION   Read this first. Contains obligatory legal
  9.                                 stuff as well as information about how to
  10.                                 reach the author.
  11.  
  12.         I.   Overview           General description of programs.
  13.  
  14.         II.  Installation and   Temporary work files (types, space
  15.              Usage Consider-    requirements, relocation, improving
  16.              ations             performance). EA size reported by EABACKUP
  17.                                 vs that reported by CHKDSK. Performance
  18.                                 tips.
  19.  
  20.         III. Command Syntax     Syntax of EABACKUP and EARESTOR.
  21.                                 Description of required and optional
  22.                                 command line parameters.
  23.  
  24.         IV.   Suggested         Step by step instructions for using
  25.               Procedure for     EABACKUP and EARESTOR along with DOS backup
  26.               backing up and    software to back up and restore a disk..
  27.               restoring a disk
  28.  
  29.         V.    Restoring In-Use  Booting from floppies to avoid "in-use"
  30.               Files             conditions on a restore.
  31.  
  32.         VI.   Backup Files      Description of backup files produced by
  33.                                 EABACKUP.  Copying backup files.
  34.  
  35.         VII.  Selective         Explains how to restore selected
  36.               Restore           directories.  Describes the directory
  37.                                 structure of the backup index.
  38.  
  39.         VIII.Environment        Environment variables recognized by
  40.              Variables          EABACKUP and EARESTOR.
  41.  
  42.         IX.  Examples           Backup to hard disk directory, list backup
  43.                                 index, delete backed up EA's, restore EA's,
  44.                                 restore selected EA's.
  45.  
  46.  
  47.                         ** IMPORTANT INFORMATION **
  48.  
  49.      This software is freeware.  However, If you find the programs useful a
  50.      contribution of $5 would be very much appreciated. Every little bit
  51.      helps, especially when it comes time to pay my Compuserve bill.  If
  52.      you already contributed for an earlier version, thanks!  No additional
  53.      contribution is necessary.  Contributions should be sent to the author
  54.      at the mailing address given at the end of this section.
  55.  
  56.      The author grants all recipients of this software and documentation
  57.      permission to freely copy and use it.  Permission to distribute the
  58.      software to others is also granted on the condition that this
  59.      "IMPORTANT INFORMATION" section is included in its entirety as part of
  60.      any such transfer and as long as no additional conditions are added.
  61.  
  62.      DISCLAIMER : Please note that this software is provided on an as-is
  63.      basis.  The author does not warrant that the functions contained in
  64.      this software will meet your requirements or that the operation of the
  65.      software will be uninterrupted or error free.  The author will not be
  66.      liable for any loss of profit, data, or use of the software, or
  67.  
  68.      special, incidental, or consequential damages, or other similar
  69.      claims, even if the author has been advised of the possibility of such
  70.      damages.  With any backup software, it is good practice to test it on
  71.      your own equipment, using non-critical data, before considering it for
  72.      day-to-day use.
  73.  
  74.      Inquiries, complaints, suggestions for improvement, and contributions
  75.      may be directed to the author via Compuserve E-Mail or by letter.  The
  76.      appropriate addresses are :
  77.  
  78.  
  79.         Compuserve ID   :       71041,736
  80.  
  81.         Mailing Address :       David Thorn
  82.                                 4056 NE 86th Street
  83.                                 Seattle, WA 98115
  84.  
  85.  
  86.                 ** END OF IMPORTANT INFORMATION SECTION **
  87.  
  88.      
  89.  
  90.  
  91.                                I.  Overview
  92.  
  93.      EABACKUP and EARESTOR are  utility programs designed to backup and
  94.      restore extended attributes associated with OS/2 files.  The programs
  95.      are run from the command line in  an OS/2 windowed or fullscreen
  96.      session.  All extended attributes in a single directory or in a
  97.      directory and its sub-directories may be backed up in one pass.
  98.      Backups may be made to a fixed disk or to a floppy.  Individual files
  99.      and directories may be restored selectively and an option is provided
  100.      that allows previously backed up extended attributes to be deleted.
  101.  
  102.      Extended attributes (EA's) were introduced with OS/2 1.2.  They are
  103.      objects associated with, but not actually part of, many OS/2 files.
  104.      OS/2 commands and utilities (such as COPY, XCOPY, BACKUP, and RESTORE)
  105.      recognize EA's and maintain the integrity of the association between
  106.      an EA and its parent file.  For example, when a file is copied or
  107.      moved using one of these commands, they copy or move the EA as well.
  108.      In contrast programs written to run under DOS, including many DOS
  109.      backup programs, do not recognize the existence of EA's.
  110.      Indescriminant use of these programs can result in "lost" EA's (a lost
  111.      EA is one that has become disconnected from its associated file).
  112.      Often lost EA's are only an annoyance, tieing up disk space to no
  113.      purpose and causing CHKDSK errors.  More serious problems may occur,
  114.      however, if EA's are disconnected from certain OS/2 system files or
  115.      files needed by OS/2 applications that recognize and use EA's.
  116.  
  117.      In order to use EABACKUP and EARESTOR effectively it is important for
  118.      you to understand a little about how EA's are connected to their
  119.      files, where they reside, and what kind of EA related errors can
  120.      occur.  EA's for all files on a FAT drive are contained in a single,
  121.      hidden file called "EA DATA. SF" in the drive's root directory.  A
  122.      file is connected to its EA through a pointer, contained in the file's
  123.      directory entry, into "EA DATA. SF".  This pointer resides in bytes
  124.      that are unused in DOS systems.  The two most common EA related errors
  125.      are lost EA's and cross-linked EA's.  Files lose their EA's when a
  126.      program that manipulates directory entries (such as backup/restore
  127.      software) does not preserve this directory pointer leaving the EA's
  128.      stranded on "EA DATA. SF".  Cross-linking, the second type of error,
  129.      occurs when two or more files point to the same location in
  130.      "EA DATA. SF".  Deleting "EA DATA. SF", for example, will leave
  131.      directory entries with pointers into a (now) non-existent EA DATA
  132.      file.  When new files with EA's are subsequently added, the EA DATA
  133.      file will regrow leading to the likelihood that an old and new pointer
  134.  
  135.      will end up pointing to the same (new) EA.  Running CHKDSK /F can
  136.      "fix" lost EA's (the orphaned entries in EA DATA are simply deleted-
  137.      the file that "lost" the EA still won't have one). Cross linked EA's
  138.      are not "fixed" by CHKDSK since OS/2 does not know who the legitimate
  139.      owner is.  Cross linking can be prevented by running CHKDSK /F to
  140.      clean up the pointers whenever "EA DATA. SF" is deleted.
  141.  
  142.      In order to avoid problems like these, IBM supplies the EAUTIL.EXE
  143.      utility with the OS/2 1.x and 2.0 base systems.  This utility can
  144.      split an EA from its parent file and place it in a holding file that a
  145.      non EA-aware program can recognize and manipulate.  It can also
  146.      reconnect an EA contained in a holding file to its parent.  One could
  147.      conceivably use EAUTIL to allow a non EA-aware backup program to
  148.      backup EA's.  Unfortunately, each invocation of EAUTIL can only
  149.      process a single file.  Thus EAUTIL would have to be invoked a
  150.      separate time for each file to be backed up.  This is clearly
  151.      impractical when large numbers of files are involved.
  152.  
  153.      EABACKUP and EARESTOR are designed to overcome this limitation of
  154.      EAUTIL.  EABACKUP automatically extracts the EA's of every file in a
  155.      single directory or a directory and its sub-directories.  The
  156.      extracted EA's are copied to a single backup file on a floppy or hard
  157.      disk.  EARESTOR uses this backup file to restore the EA's to their
  158.      parents.  Note that these programs use OS/2 2.0 functions to backup
  159.      and redstore EA's so they will not run under OS/2 version 1.x or DOS.
  160.  
  161.      NOTE: If your drive is FAT and your backup software backs up AND
  162.      restores an exact image of your directory entries (INCLUDING the
  163.      "unused bytes" that are really occupied by the EA pointer), backs up
  164.      and restores empty directories, successfully backs up and restores
  165.      "EA DATA. SF", and you never do partial backups or restores (ie you do
  166.      full drive backup/restore only) then you do not need to back up the
  167.      EA's separately using EABACKUP and EARESTOR.  If any of these
  168.      conditions are not met, however, and you care about your EA's then you
  169.      will need to use this software (or something like it) until such time
  170.      as you get OS/2 aware backup software.
  171.  
  172.  
  173.                  II. Installation and Usage Considerations
  174.  
  175.      1) EABACKUP and EARESTOR both use temporary work files as part of
  176.         their processing.  There are two types of work files.  The first is
  177.         used to provide a scratch pad area for the backup index and the
  178.         second is used to provide a temporary holding area for EA's as they
  179.         are moved to and from the backup disk.  The size of the EA holding
  180.         file should not exceed 64K which is the maximum size of EA's under
  181.         OS/2 versions 1.x and 2.0.  The maximum size of the index scratch
  182.         pad area varies depending on the number of files and directories
  183.         processed and the size of the file names.  100K should be more than
  184.         sufficient for most situations.
  185.         
  186.         The default location of EABACKUP's work files is the root directory
  187.         of the source disk.  For EARESTOR it is the root directory of the
  188.         destination disk.  Alternate locations for both types of work files
  189.         can specified by using the EATEMPW and EATEMPF environment
  190.         variables or the "/W" and "/F" command line options.  EATEMPW and
  191.         /W relocate the index scratch pad while EATEMPF and /F do the same
  192.         for the EA holding file.  Performance improvements can be obtained
  193.         by using EATEMPF or /F to relocate the holding file to a virtual
  194.         (RAM) disk (for information on setting up a RAM disk see the OS/2
  195.         command reference). The minimum size of this disk should be the
  196.         size of the largest possible EA (64K).
  197.  
  198.      2) When backing up all EA's on a FAT based drive, the total length of
  199.         the EA's reported by EABACKUP will generally be considerably less
  200.         than the amount of allocated EA space reported by CHKDSK.  This is
  201.         normal.  The number reported by EABACKUP represents the amount of
  202.         the space reserved for EA's that actually contained data.  The
  203.         difference between the EABACKUP and CHKDSK numbers represents space
  204.         that was allocated but unused.  There normally is a large amount of
  205.         unused space since the minimum allocation for an EA is equal to the
  206.         cluster size for the disk.  The cluster size varies depending on
  207.         the disk capacity but is usually 2048 bytes or more.  A 100 byte EA
  208.         will allocate 2048 bytes, 1948 of which will be unused (and
  209.         unusable unless that particular EA expands).
  210.  
  211.      3) A number of things can be done to improve performance. These are
  212.         listed in decreasing order of efficacy.
  213.  
  214.         a) Use the hard disk as the target for EABACKUP files or the source
  215.            of EARESTOR files. After they are created backup files produced
  216.            by EABACKUP may be copied to a floppy or backed up using normal
  217.            DOS backup software (see section V. for more on backup files).
  218.  
  219.         b) Use the /F command line option or the EATEMPF environment
  220.            variable to direct the EA holding file to a RAM disk of 64K in
  221.            size or more (see VDISK.SYS in the OS/2 Command Reference on
  222.            setting up a RAM disk).
  223.  
  224.  
  225.                             III. Command Syntax
  226.  
  227.      In the following, source_path, destination_path, and path_name should
  228.      be replaced by a valid OS/2 path name (with or without a drive
  229.      specifier) or a drive specifier alone (eg A:, B:, etc).  If a path
  230.      name is specified without a drive specifier then EABACKUP assumes the
  231.      source drive and EARESTOR assumes the destination drive.  If a drive
  232.      specifier is specified without a path then the current directory on
  233.      that drive is assumed.
  234.  
  235.      source_path and destination_path are required.  All other parameters
  236.      are optional.
  237.  
  238.      
  239.  
  240.      
  241.      EABACKUP.EXE is invoked from the OS/2 command line as follows :
  242.      
  243.      |-----------------------------------------------------------------|
  244.      |    EABACKUP  source_path  destination_path                      |
  245.      |                                                                 |
  246.      |              /S   /W=path_name  /F=path_name                    |
  247.      |                                                                 |
  248.      |              /Q  /I                                             |
  249.      |-----------------------------------------------------------------|
  250.  
  251.      Where :
  252.  
  253.  
  254.         source_path             The path name of the highest level
  255.         (required)              directory to back up.
  256.  
  257.         destination_path        The path name of the directory that will
  258.         (required)              receive the backup files.  If backing up to
  259.                                 a floppy, only the drive specifier (A:, B:
  260.                                 etc) should be used.
  261.  
  262.         /S                      Optional switch which, if specified,
  263.                                 instructs EABACKUP to process all sub-
  264.                                 directories below the directory indicated
  265.                                 in source_path as well as source_path
  266.                                 itself.
  267.  
  268.         /W=path_name            Used to specify location of temporary work
  269.         /F=path_name            files. /W specifies the location of the
  270.                                 index scratch pad and /F specifies the
  271.                                 location of the temporary EA holding area
  272.                                 (see Installation Considerations item 2 for
  273.                                 further information). If these parameters
  274.                                 are omitted then the directories specified
  275.                                 in the environment variables EATEMPW and
  276.                                 EATEMPF determine the location of the work
  277.                                 files. If those environment variables are
  278.                                 not specified then the work files will be
  279.                                 located in the root directory of the source
  280.                                 drive.
  281.  
  282.         /Q                      Causes EABACKUP to operate in "Quiet" mode.
  283.                                 This suppresses attention getting tones
  284.                                 generated when an error occurs or when an
  285.                                 operator reply is required.
  286.  
  287.         /I                      This causes EABACKUP to continue without
  288.                                 interruption when an EAUTIL.EXE error is
  289.                                 detected (this normally happens when a file
  290.                                 is in-use).  If this parameter is omitted
  291.                                 EABACKUP will pause and ask the operator
  292.                                 for permission to proceed despite the
  293.                                 error.
  294.  
  295.      
  296.  
  297.      
  298.  
  299.      
  300.      EARESTOR.EXE is invoked from the OS/2 command line as follows :
  301.      
  302.      |-----------------------------------------------------------------|
  303.      |    EARESTOR  source_path  destination_path                      |
  304.      |                                                                 |
  305.      |               /S  /W=path_name  /F=path_name                    |
  306.      |                                                                 |
  307.      |               /D  /M=file_mask   /B=path_name  /L  /Q  /I  /X   |
  308.      |-----------------------------------------------------------------|
  309.  
  310.      Where :
  311.  
  312.      
  313.  
  314.         source_path             The path name of the directory containing
  315.         (required)              the backup files.  If restoring from a
  316.                                 floppy, only the drive specifier (A:, B:,
  317.                                 etc) should be used.
  318.  
  319.         destination_path        The path name of the directory that will be
  320.         (required)              the restore target.
  321.  
  322.         /S                      Optional switch which, if specified,
  323.                                 instructs EARESTOR to process all sub-
  324.                                 directories below the directory indicated
  325.                                 in  destination_path as well as
  326.                                 destination_path itself.
  327.  
  328.         /W=path_name            Used to specify location of temporary work
  329.         /F=path_name            files. /W specifies the location of the
  330.                                 index scratch pad and /F specifies the
  331.                                 location of the temporary EA holding area
  332.                                 (see Installation Considerations item 2 for
  333.                                 further information). If these parameters
  334.                                 are omitted then the directories specified
  335.                                 in the environment variables EATEMPW and
  336.                                 EATEMPF determine the location of the work
  337.                                 files. If those environment variables are
  338.                                 not specified then the work files will be
  339.                                 located in the root directory of the source
  340.                                 drive.
  341.  
  342.         /D                      Instructs EARESTOR to delete EA's on the
  343.                                 destination drive that correspond to those
  344.                                 contained on the backup file. The EA's on
  345.                                 the backup file itself are not affected.
  346.                                 Note that an EA that appears on the
  347.                                 destination drive but does not appear in
  348.                                 the backup file will not be deleted.
  349.                                 
  350.                                 If /D is not specified EARESTOR will
  351.                                 restore the EA's on the backup file to the
  352.                                 destination disk.
  353.  
  354.         /M=file_mask            Instructs EARESTOR to restore only those
  355.                                 EA's associated with files whose names
  356.                                 match the file_mask.  The file_mask should
  357.                                 be replaced by a valid OS/2 file name which
  358.                                 can contain wild cards (no directory should
  359.                                 be specified).  If this parameter is not
  360.                                 specified then all files will be restored
  361.                                 (equivalent to specifying /M=*).
  362.  
  363.         /B=path_name            Instructs EARESTOR to skip to the backup
  364.                                 file directory named in path_name before
  365.                                 starting the restore. The path_name should
  366.                                 not contain any drive information and
  367.                                 should be relative to the first directory
  368.                                 in the backup file. Only EA's in the backup
  369.                                 directory indicated by path_name (and its
  370.                                 children if /S is specified) will be
  371.                                 restored. For example if the backup was
  372.                                 performed on a disk with the following
  373.                                 directory structure :
  374.                                 
  375.                                                  D0
  376.                                                  |
  377.                                             |---------|
  378.                                             |         |
  379.                                            D1         D2
  380.                                             |
  381.                                        |--------|
  382.                                        |        |
  383.                                       D1A      D1B
  384.                                 
  385.                                 then /B=D1 will restore D1, D1A, and D1B to
  386.                                 the destination_path.  Similarly, /B=D1\D1A
  387.                                 will restore D1A.  Note that the name of
  388.                                 the first backup directory (D0 in this
  389.                                 example) is never included as part of
  390.                                 path_name.
  391.  
  392.         /L                      Instructs EARESTOR to list the backup
  393.                                 index.  If this option is specified then
  394.                                 the backup index will be listed but no
  395.                                 other action will be performed.  By
  396.                                 default, the listing is directed to the
  397.                                 video display.  It can be redirected to
  398.                                 another device in the normal way.
  399.  
  400.         /Q                      Causes EARESTOR to operate in "Quiet" mode.
  401.                                 This suppresses attention getting tones
  402.                                 generated when an error occurs or when an
  403.                                 operator reply is required.
  404.  
  405.         /I                      This causes EARESTOR to continue without
  406.                                 interruption when an EA error is detected
  407.                                 (this normally happens when a file is in-
  408.                                 use or can't be found).  If this parameter
  409.                                 is omitted EARESTOR will pause and ask the
  410.                                 operator for permission to proceed despite
  411.                                 the error.
  412.  
  413.         /C                      This causes EARESTOR to create directories
  414.                                 it finds on the backup but not on the
  415.                                 target.  This is mainly for use if you have
  416.                                 DOS backup software that doesn't back up
  417.                                 empty directories. If so, EARESTOR can
  418.                                 recreate them for you if you specify /C.
  419.  
  420.         /X                      This causes EARESTOR to skip the restore of
  421.                                 the EA associated with the starting
  422.                                 directory.  For example, if you specify :
  423.                                 "EARESTOR B: F:\DIR1 /X", the EA associated
  424.                                 with DIR1 itself (if any) will not be
  425.                                 restored.  All EA's associated with files
  426.                                 and directories under DIR1 will be restored
  427.                                 as usual.
  428.  
  429.  
  430.                    IV.  Example Backup/Restore Procedure
  431.  
  432.      Here's the procedure I use to backup my hard disk (for the purposes of
  433.      the discussion I'll call it "F:" using EABACKUP & EARESTOR and my DOS
  434.      backup software :
  435.  
  436.                                 BACKUP
  437.  
  438.      1) Do a CHKDSK F: to make sure everything's OK.
  439.  
  440.      2) Run "EABACKUP F:\ F:\ /s". This will create a EA backup file in
  441.         the root directory of your F: drive.
  442.  
  443.      3) Boot DOS and run your backup software to back up drive F:. Be sure
  444.         to back up the EA backup files produced in step 2 (their names are
  445.         EA@BDATA.EAB and EA@INDEX.EAB).  There's no need to back up
  446.         "EA DATA. SF" but there's no harm in doing so. You are now done.
  447.  
  448.                                  RESTORE
  449.  
  450.      1) Boot DOS and run your restore software. Be sure to restore the EA
  451.         backup files.
  452.  
  453.      2) Boot OS/2 (from floppies if necesssary). Do a CHKDSK F: /f to get
  454.         rid of any lost EA's that may have been created by the restore. If
  455.         you restored "EA DATA. SF" in step 1 then this step is necessary to
  456.         get rid of the old EA's on "EA DATA. SF" that are no longer
  457.         connected to their files.  If you don't do this then the old EA's
  458.  
  459.         will take up space for no purpose and your "EA DATA. SF" file will
  460.         end up being twice as big as it needs to be (at least until the
  461.         next CHKDSK /f is run against the drive and the old "lost" EA's are
  462.         deleted).
  463.  
  464.      3) Run "EARESTOR F:\ F:\ /s" to reconnect the EA's to their files.
  465.  
  466.  
  467.                          V. Restoring In-Use Files
  468.  
  469.      EARESTOR can not process EA's associated with files that are in use by
  470.      another process.  If you encounter this condition while performing a
  471.      restore you can choose to ignore it or you can retry the backup or
  472.      restore after identifying and terminating the process responsible.  If
  473.      termination of the process is not possible, as is the case when the
  474.      condition is caused by OS/2 itself, and you still wish restore the EA
  475.      you must use an alternate procedure, described here, that involves
  476.      booting the system from the OS/2 installation diskettes.  The
  477.      procedure is as follows :
  478.  
  479.      1) Boot OS/2 from drive A: using the OS/2 installation diskette(s).
  480.         When the boot process is complete (this will involve 1 disk change
  481.         for OS/2 version 2.0) and the first installation screen is
  482.         displayed, cancel the installation process by using the Esc key.
  483.         This should leave you at the A> prompt.
  484.  
  485.      2) Run EARESTOR.
  486.  
  487.      Performance can be improved by using the /F parameter to direct the
  488.      temporary EA holding file to a RAM disk.  The version of OS/2 2.0 that
  489.      I had access to when I wrote this program did not create a RAM drive
  490.      when booting from the floppy.  To create one :
  491.  
  492.      1) Create a working copy of the diskette(s) used in the boot process.
  493.  
  494.      2) Check the CONFIG.SYS file (located on the last diskette used when
  495.         booting) and look for a "DEVICE=VDISK.SYS..." entry.  If one is
  496.         present then OS/2 is already creating a RAM disk.  If the disk is
  497.         at least 64K in size then you can use it as-is.  If it is smaller
  498.         you should change the parameters to make it 64K (see the VDISK.SYS
  499.         topic in the OS/2 Command Reference for information on how this is
  500.         done).  If there is no VDISK.SYS then proceed to the next step.
  501.  
  502.      3) Add a DEVICE=VDISK.SYS statement to CONFIG.SYS.  Make sure that
  503.         VDISK.SYS is on the same floppy as CONFIG.SYS.  If it isn't you
  504.         must copy it there from the OS2 directory on your hard drive.
  505.  
  506.      4) Boot from the floppy, determine the drive letter associated with
  507.         the RAM drive, and point to it using the /F option when the backup
  508.         or restore is run.
  509.  
  510.      
  511.  
  512.  
  513.                              VI. Backup Files
  514.  
  515.      A backup created by EABACKUP consists of two files, a data component
  516.      named EA@BDATA.EAB and an index component named EA@INDEX.EAB.  If the
  517.      backup is to a diskette and there is insufficient room on a single
  518.      diskette to hold all the backup data or the index, additional
  519.      instances of EA@BDATA.EAB and/or EA@INDEX.EAB are created on overflow
  520.      volumes.  The backup files may be copied using normal commands.  A
  521.      backup on a fixed disk can be copied to a floppy as long as the data
  522.      and index components are kept together and will fit on a single
  523.      floppy.  Similarly, a backup residing entirely on a single floppy may
  524.      be copied to a fixed disk.  In this case the data and index components
  525.      must each be copied to the same directory.  Backups residing on
  526.      multiple floppies can not be run from a fixed disk.
  527.  
  528.      
  529.  
  530.  
  531.                           VII.  Selective Restore
  532.  
  533.      Backup files produced by EABACKUP preserve information about the
  534.      directory structure of backed up data.  This information consists of
  535.      the names of any sub-directories that were backed up as a result of
  536.      using the /S parameter but does not include the name of the source
  537.      drive or initial directory.  This is illustrated by the following
  538.      example.  If the command :
  539.  
  540.                          EABACKUP E:\DIR0 A: /S
  541.  
  542.      is issued, the results are as follows :
  543.      
  544.      
  545.      Original          E:\                 Structure    (no name)
  546.      Structure          |                  on backup        |
  547.                         |                  file             |
  548.                   ------------                      -----------------
  549.                   |          |                      |       |       |
  550.                   |          |                      |       |       |
  551.                 DIR0        DIR1                 DIR0_A   DIR0_B  DIR0_C
  552.                   |                                         |
  553.                   |                                         |
  554.           ----------------                               DIR0_BA
  555.           |       |      |
  556.           |       |      |
  557.         DIR0_A  DIR0_B  DIR0_C
  558.                   |
  559.                   |
  560.                DIR0_BA
  561.      
  562.  
  563.      This relative nature of the backup's structure allows EA's to be
  564.      restored to any initial directory on any drive as long as the
  565.      directory structure under the new target location corresponds to that
  566.      under the original data source.  Using the example above, the
  567.      following command would be successful :
  568.  
  569.                          EARESTOR  A:  C:\NEW_DIR  /S
  570.  
  571.      if the target directory structure was :
  572.      
  573.                                 C:\
  574.                                  |
  575.                                  |
  576.                               NEW_DIR
  577.                                  |
  578.                           ---------------
  579.                           |      |      |
  580.                           |      |      |
  581.                        DIR0_A  DIR0_B  DIR0_C
  582.                                  |
  583.                                  |
  584.                               DIR0_BA
  585.      
  586.  
  587.      The /B parameter of EARESTOR allows a restore to selectively restore a
  588.      directory other than the initial one on the backup.  The data in
  589.      directories hierarchically above the directory specified in the /B
  590.      option is ignored.  Again using the previous example, specifying :
  591.  
  592.                 EARESTOR  A:  C:\NEW_DIR\DIR0_B  /B=DIR0_B  /S
  593.  
  594.      
  595.      would selectively restore EA's in C:\NEW_DIR\DIR0_B and
  596.      C:\NEW_DIR\DIR0_BA.
  597.  
  598.      The /M parameter causes EARESTOR to restore only those EA's whose
  599.      parent files match the file name mask specified in /M.  The file name
  600.      mask specified in /M can contain wild card characters. For example,
  601.      specifying :
  602.  
  603.                     EARESTOR A: C\NEW_DIR /S /M=*.EXE
  604.  
  605.      would only restore EA's associated with files with an EXE extension.
  606.  
  607.  
  608.               VIII. Environment Variables EATEMPF and EATEMPW
  609.  
  610.      
  611.  
  612.      Two environment variables named EATEMPF and EATEMPW are recognized by
  613.      EABACKUP.EXE and EARESTOR.EXE.  They have the same meaning as the /F
  614.      and /W command line parameters (see the Command Syntax section for a
  615.      description).  To use them, include the following lines in your
  616.      CONFIG.SYS file or type them on the command line prior to running
  617.      EABACKUP or EARESTOR :
  618.  
  619.                         --------------------------------
  620.                         |    SET EATEMPW=path_name     |
  621.                         |                              |
  622.                         |    SET EATEMPF=path_name     |
  623.                         --------------------------------
  624.                                           
  625.  
  626.      Where path_name should be replaced by a valid OS/2 path name.
  627.  
  628.      The /W and /F command line options, if specified, override the value
  629.      of the corresponding environment variable.
  630.  
  631.  
  632.                                IX. Examples
  633.  
  634.      1) Backup EA's from current directory on the C drive to a floppy on
  635.         the A drive using the /S option to back up subdirectories.
  636.         
  637.                EABACKUP C: A: /S
  638.         
  639.  
  640.      2) Backup EA's from C:\DIR0 and its subdirectories to hard disk
  641.         directory E:\BKUP with the EA holding file being directed to the G:
  642.         drive and the index work file being directed to the E:\JUNK
  643.         directory.
  644.         
  645.                EABACKUP C:\DIR0 E:\BKUP /S /F=G: /W=E:\JUNK
  646.         
  647.  
  648.      3) List backup index for data backed up in Example 2. Redirect output
  649.      to a printer :
  650.      
  651.             EARESTOR E:\BKUP C:\DIR0 /S /L > PRN:
  652.      
  653.      Pipe output to MORE filter :
  654.      
  655.             EARESTOR E:\BKUP C:\DIR0 /S /L | MORE
  656.  
  657.      4) Delete from their parents, EA's that were backed up in Example 2 :
  658.      
  659.             EARESTOR E:\BKUP C:\DIR0 /S /D
  660.  
  661.      5) Restore EA's backed up in Example 2 :
  662.      
  663.             EARESTOR E:\BKUP C:\DIR0 /S
  664.  
  665.      6) Restore only those EA's backed up in Example 2 whose parent files
  666.      have an EXE extension :
  667.      
  668.             EARESTOR E:\BKUP C:\DIR0 /S /M=*.EXE
  669.